设置目录组织模式 - LogSetDirMode

函数简介

设置日志文件的目录组织模式，支持按日期、模块、级别、小时等多种方式组织日志文件。

接口名称

LogSetDirMode

DLL调用

int32_t LogSetDirMode(int64_t instance, int64_t loggerHandle, int32_t dirMode);

参数说明

参数名	类型	说明
instance	长整数型	OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
loggerHandle	长整数型	日志实例句柄（0 表示默认实例）。
dirMode	整数型	目录模式（可位或组合），见 LogDirMode 枚举。

LogDirMode 枚举值

枚举值	值	说明
OLA_LOG_DIR_FLAT	0	平铺模式（所有日志在同一目录）
OLA_LOG_DIR_BY_DATE	1	按日期分目录 (2026-02-27/)
OLA_LOG_DIR_BY_MODULE	2	按模块分目录 (network/)
OLA_LOG_DIR_BY_LEVEL	4	按级别分目录 (error/)
OLA_LOG_DIR_BY_HOUR	8	按小时分目录 (2026-02-27-14/)

位运算组合示例

将需要的目录组织方式 按位或（|）相加 后传入 dirMode（多种模式同时生效时目录层级叠加）：

csharp

// 按日期 + 按模块分目录
int dirMode = 1 | 2;  // OLA_LOG_DIR_BY_DATE | OLA_LOG_DIR_BY_MODULE
ola.LogSetDirMode(0, dirMode);

// 按日期 + 按级别 + 按小时
int dirMode2 = 1 | 4 | 8;  // 13
ola.LogSetDirMode(0, dirMode2);

cpp

// 按日期 + 按级别分目录
int dirMode = 1 | 4;  // 5
ola.LogSetDirMode(0, dirMode);

python

# 平铺模式（所有日志在同一目录）
ola.LogSetDirMode(0, 0)

# 按日期 + 按模块
ola.LogSetDirMode(0, 1 | 2)

示例

DirMode：DATE=1 MODULE=2 LEVEL=4 HOUR=8，可按位或。先设 ModuleName，再设 1|2（按日期+模块分子目录）。

SDK 调用

cpp

#include "OLAPlugServer.h"
#include <cstdio>

OLAPlugServer ola;
const int64_t logger = 0; // 默认实例

ola.LogSetBaseDirectory(logger, "D:\\logs");
ola.LogSetModuleName(logger, "network");
// DATE|MODULE → 例如 D:\logs\2026-03-02\network\...
int ret = ola.LogSetDirMode(logger, 1 | 2); // DATE | MODULE
if (ret != 1) {
    return;
}
ola.LogSetFileNamePattern(logger, "app_{date}.log");
ola.LogInfo("dir mode DATE|MODULE");
std::string path = ola.LogGetCurrentFilePath(logger);
std::printf("current log file: %s\n", path.c_str());

csharp

using System;
using OLAPlug;

var ola = new OLAPlugServer();
long logger = 0;

ola.LogSetBaseDirectory(logger, @"D:\logs");
ola.LogSetModuleName(logger, "network");
// DATE|MODULE → 例如 D:\logs\2026-03-02\network\...
int ret = ola.LogSetDirMode(logger, 1 | 2); // DATE | MODULE
if (ret != 1) return;
ola.LogSetFileNamePattern(logger, "app_{date}.log");
ola.LogInfo("dir mode DATE|MODULE");
string path = ola.LogGetCurrentFilePath(logger);
Console.WriteLine("current log file: " + path);

python

from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
logger = 0

ola.LogSetBaseDirectory(logger, r"D:\logs")
ola.LogSetModuleName(logger, "network")
# DATE|MODULE → 例如 D:\logs\2026-03-02\network\...
ret = ola.LogSetDirMode(logger, 1 | 2)  # DATE | MODULE
if ret != 1:
    raise RuntimeError("failed")
ola.LogSetFileNamePattern(logger, "app_{date}.log")
ola.LogInfo("dir mode DATE|MODULE")
path = ola.LogGetCurrentFilePath(logger)
print("current log file:", path)

java

import com.olaplug.OLAPlugServer;

OLAPlugServer ola = new OLAPlugServer();
long logger = 0;

ola.LogSetBaseDirectory(logger, "D:\\logs");
ola.LogSetModuleName(logger, "network");
// DATE|MODULE → 例如 D:\logs\2026-03-02\network\...
int ret = ola.LogSetDirMode(logger, 1 | 2); // DATE | MODULE
if (ret != 1) {
    return;
}
ola.LogSetFileNamePattern(logger, "app_{date}.log");
ola.LogInfo("dir mode DATE|MODULE");
String path = ola.LogGetCurrentFilePath(logger);
System.out.println("current log file: " + path);

import (
    "fmt"
    "github.com/ola/olaplug/olaplug"
)

ola, _ := olaplug.NewOLAPlugServer("OLAPlug_x64.dll")
defer ola.ReleaseObj()
logger := int64(0)

ola.LogSetBaseDirectory(logger, `D:\logs`)
ola.LogSetModuleName(logger, "network")
// DATE|MODULE → 例如 D:\logs\2026-03-02\network\...
ret := ola.LogSetDirMode(logger, 1 | 2) // DATE | MODULE
if ret != 1 {
    return
}
ola.LogSetFileNamePattern(logger, "app_{date}.log")
ola.LogInfo("dir mode DATE|MODULE")
path := ola.LogGetCurrentFilePath(logger)
fmt.Println("current log file:", path)

rust

use olaplug::OLAPlugServer;

let ola = OLAPlugServer::new("OLAPlug_x64.dll").unwrap();
let logger = 0i64;

ola.log_set_base_directory(logger, r"D:\logs");
ola.log_set_module_name(logger, "network");
// DATE|MODULE → 例如 D:\logs\2026-03-02\network\...
let ret = ola.log_set_dir_mode(logger, 1 | 2); // DATE | MODULE
if ret != 1 {
    return;
}
ola.log_set_file_name_pattern(logger, "app_{date}.log");
ola.log_info("dir mode DATE|MODULE");
let path = ola.log_get_current_file_path(logger);
println!("current log file: {}", path);

cpp

var ola = com("OlaPlug.OlaSoft")
var logger = 0

ola.LogSetBaseDirectory(logger, "D:\\logs")
ola.LogSetModuleName(logger, "network")
// DATE|MODULE → 例如 D:\logs\2026-03-02\network\...
var ret = ola.LogSetDirMode(logger, 1 | 2) // DATE | MODULE
if(ret == 1) {
    ola.LogSetFileNamePattern(logger, "app_{date}.log")
    ola.LogInfo("dir mode DATE|MODULE")
    var path = ola.LogGetCurrentFilePath(logger)
    traceprint("current log file: " + path)
}

vbscript

Set ola = CreateObject("OlaPlug.OlaSoft")
logger = 0

ola.LogSetBaseDirectory logger, "D:\logs"
ola.LogSetModuleName logger, "network"
' DATE|MODULE → 例如 D:\logs\2026-03-02\network\...
ret = ola.LogSetDirMode(logger, 3)
If ret = 1 Then
    ola.LogSetFileNamePattern logger, "app_{date}.log"
    ola.LogInfo "dir mode DATE|MODULE"
    path = ola.LogGetCurrentFilePath(logger)
    TracePrint "current log file: " & path
End If

text

.局部变量 ola, OLAPlug
.局部变量 ret, 整数型
.局部变量 logger, 长整数型
.局部变量 path, 文本型

ola.Create ()
logger ＝ 0

ola.LogSetBaseDirectory (logger, “D:\logs”)
ola.LogSetModuleName (logger, “network”)
' DATE|MODULE → 例如 D:\logs\2026-03-02\network\...
ret ＝ ola.LogSetDirMode (logger, 位或 (1, 2))  ' DATE | MODULE
.如果真 (ret ＝ 1)
    ola.LogSetFileNamePattern (logger, “app_{date}.log”)
    ola.LogInfo (“dir mode DATE|MODULE”)
    path ＝ ola.LogGetCurrentFilePath (logger)
    调试输出 (“current log file：”, path)
.如果真结束

aardio

import OLAPlugServer;
var ola = OLAPlugServer();
var logger = 0;

ola.LogSetBaseDirectory(logger, "D:\\logs");
ola.LogSetModuleName(logger, "network");
// DATE|MODULE → 例如 D:\logs\2026-03-02\network\...
var ret = ola.LogSetDirMode(logger, 1 | 2); // DATE | MODULE
if(ret == 1){
    ola.LogSetFileNamePattern(logger, "app_{date}.log");
    ola.LogInfo("dir mode DATE|MODULE");
    var path = ola.LogGetCurrentFilePath(logger);
    io.print("current log file: ", path);
}

text

变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
长整数 logger = 0

ola.LogSetBaseDirectory(logger, "D:\\logs")
ola.LogSetModuleName(logger, "network")
' DATE|MODULE → 例如 D:\logs\2026-03-02\network\...
整数 ret = ola.LogSetDirMode(logger, 1 位或 2)  ' DATE | MODULE
如果真 (ret ＝ 1)
{
    ola.LogSetFileNamePattern(logger, "app_{date}.log")
    ola.LogInfo("dir mode DATE|MODULE")
    文本 path = ola.LogGetCurrentFilePath(logger)
    调试输出 ("current log file：", path)
}

cpp

#include "OLAPlugServer.h"
#include <cstdio>

OLAPlugServer ola;
int64_t logger = 0;

ola.LogSetBaseDirectory(logger, "D:\\logs");
ola.LogSetModuleName(logger, "network");
// DATE|MODULE → 例如 D:\logs\2026-03-02\network\...
int32_t ret = ola.LogSetDirMode(logger, 1 | 2); // DATE | MODULE
if (ret != 1) {
    return;
}
ola.LogSetFileNamePattern(logger, "app_{date}.log");
ola.LogInfo("dir mode DATE|MODULE");
std::string path = ola.LogGetCurrentFilePath(logger);
std::printf("current log file: %s\n", path.c_str());

原生 DLL 调用

cpp

long instance = CreateCOLAPlugInterFace();
long logger = 0;

LogSetBaseDirectory(instance, logger, "D:\\logs");
LogSetModuleName(instance, logger, "network");
int ret = LogSetDirMode(instance, logger, 1 | 2); // DATE | MODULE
if (ret != 1) {
    return;
}
LogSetFileNamePattern(instance, logger, "app_{date}.log");
LogInfo(instance, "dir mode DATE|MODULE");
// 目录布局示例：D:\logs\2026-03-02\network\app_2026-03-02.log

csharp

using System.Runtime.InteropServices;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long CreateCOLAPlugInterFace();
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogSetBaseDirectory(long ola, long loggerHandle, string baseDirectory);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogSetModuleName(long ola, long loggerHandle, string moduleName);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogSetDirMode(long ola, long loggerHandle, int dirMode);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogSetFileNamePattern(long ola, long loggerHandle, string fileNamePattern);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogInfo(long ola, string message);

long instance = CreateCOLAPlugInterFace();
long logger = 0;

LogSetBaseDirectory(instance, logger, @"D:\logs");
LogSetModuleName(instance, logger, "network");
int ret = LogSetDirMode(instance, logger, 1 | 2);
if (ret != 1) return;
LogSetFileNamePattern(instance, logger, "app_{date}.log");
LogInfo(instance, "dir mode DATE|MODULE");

python

from ctypes import CDLL, c_int, c_int64

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
instance = ola.CreateCOLAPlugInterFace()
logger = 0

ola.LogSetBaseDirectory(instance, logger, b"D:\\logs")
ola.LogSetModuleName(instance, logger, b"network")
ret = ola.LogSetDirMode(instance, logger, 1 | 2)  # DATE | MODULE
if ret != 1:
    raise RuntimeError("LogSetDirMode failed")
ola.LogSetFileNamePattern(instance, logger, b"app_{date}.log")
ola.LogInfo(instance, b"dir mode DATE|MODULE")

返回值

返回值	说明
`1`	成功。
`0`	失败。

注意事项

项目	说明
默认值	`OLA_LOG_DIR_FLAT` (0) - 平铺模式。
可以使用位或运算（`	`）组合多种模式
OLA_LOG_DIR_BY_MODULE	使用 `OLA_LOG_DIR_BY_MODULE` 时需要先调用 `LogSetModuleName` 设置模块名称。
修改后立即生效	修改后立即生效，如果日志系统已初始化，会自动重新初始化。
目录结构的顺序为	日期 → 模块 → 级别 → 小时。

设置目录组织模式 - LogSetDirMode ​

函数简介 ​

接口名称 ​

DLL调用 ​

参数说明 ​

LogDirMode 枚举值 ​

位运算组合示例 ​

示例 ​

SDK 调用 ​

原生 DLL 调用 ​

返回值 ​

注意事项 ​

设置目录组织模式 - LogSetDirMode

函数简介

接口名称

DLL调用

参数说明

LogDirMode 枚举值

位运算组合示例

示例

SDK 调用

原生 DLL 调用

返回值

注意事项